Add real features to your app

// Example: generate alt text with OpenAI
import OpenAI from "openai";

export default async (req: Request) => {
  const { description } = await req.json();
  const client = new OpenAI();

  const res = await client.responses.create({
    model: "gpt-5-mini",
    input: [
      { role: "user", content: `Write concise alt text for: ${description}` },
    ],
  });

  return Response.json({ altText: res.output_text });
};

export const config = { path: "/api/alt-text" };

// Example: return products from an API
export default async (req: Request) => {
  const url = new URL(req.url);
  const category = url.searchParams.get("category");

  const products = await getProducts({ category });
  return Response.json({ products });
};

export const config = { path: "/api/products" };

// Example: generate a report in the background
export const config = { background: true };

export default async (req: Request) => {
  const { reportId } = await req.json();
  // runs well past a normal request — no one's waiting on the response
  await buildAndStoreReport(reportId);
};

// Example: send a daily digest on a schedule
export const config = { schedule: "@daily" };

export default async () => {
  // runs once a day on its own
  await sendDailyDigest();
};

// Example: gate a dashboard behind auth
import { getContext } from "@netlify/functions";

export default async (req: Request) => {
  const { account } = getContext();
  if (!account) {
    return new Response("Sign in to continue", { status: 401 });
  }

  const data = await getDashboardData(account.id);
  return Response.json({ data });
};

export const config = { path: "/api/dashboard" };

// Example: handle a Stripe webhook
export default async (req: Request) => {
  const event = await req.json();

  if (event.type === "checkout.session.completed") {
    const session = event.data.object;
    // mark the order paid, grant access, send a receipt...
    await fulfillOrder(session);
  }

  return Response.json({ received: true });
};

export const config = { path: "/api/stripe-webhook" };